home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / lge.z / lge
Encoding:
Text File  |  2002-10-03  |  3.8 KB  |  78 lines
  1. LGE(3I)                                               Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      LLGGEE, LLGGTT, LLLLEE, LLLLTT - Compares strings lexically
  6.  
  7. SSYYNNOOPPSSIISS
  8.      LLGGEE (([SSTTRRIINNGG__AA==]_s_t_r_i_n_g__a,, [SSTTRRIINNGG__BB==]_s_t_r_i_n_g__b))
  9.  
  10.      LLGGTT (([SSTTRRIINNGG__AA==]_s_t_r_i_n_g__a,, [SSTTRRIINNGG__BB==]_s_t_r_i_n_g__b))
  11.  
  12.      LLLLEE (([SSTTRRIINNGG__AA==]_s_t_r_i_n_g__a,, [SSTTRRIINNGG__BB==]_s_t_r_i_n_g__b))
  13.  
  14.      LLLLTT (([SSTTRRIINNGG__AA==]_s_t_r_i_n_g__a,, [SSTTRRIINNGG__BB==]_s_t_r_i_n_g__b))
  15.  
  16. IIMMPPLLEEMMEENNTTAATTIIOONN
  17.      UNICOS, UNICOS/mk, IRIX systems
  18.  
  19.      CF90, MIPSpro 7 Fortran 90, MIPSpro Fortran 77
  20.  
  21. SSTTAANNDDAARRDDSS
  22.      Fortran
  23.  
  24. DDEESSCCRRIIPPTTIIOONN
  25.      Each of these type logical functions takes two character string
  26.      arguments and returns a logical value.  _s_t_r_i_n_g__a and _s_t_r_i_n_g__b are
  27.      compared according to the ASCII collating sequence, and the resulting
  28.      true or false value is returned.
  29.  
  30.      _s_t_r_i_n_g__a and _s_t_r_i_n_g__b    Must be of type default character
  31.  
  32.      The defining equation for each function is as follows:
  33.  
  34.      * For LLGGEE, logic = _a  is greater than or equal to _a
  35.                          1                              2
  36.      * For LLGGTT, logic = _a  is greater than _a
  37.                          1                  2
  38.      * For LLLLEE, logic = _a  is less than or equal to _a
  39.                          1                           2
  40.      * For LLLLTT, logic = _a  is less than _a
  41.                          1               2
  42.      LLGGEE, LLGGTT, LLLLEE, and LLLLTT are elemental functions.  The names of these
  43.      intrinsics cannot be passed as arguments.
  44.  
  45. RREETTUURRNN VVAALLUUEESS
  46.      If the strings are of unequal length, the comparison is made as if the
  47.      shorter string were extended on the right with blanks to the length of
  48.      the longer string.  The return value of each intrinsic is as follows:
  49.  
  50.      * LLGGEE.  The result is true if the strings are equal or if _s_t_r_i_n_g__a
  51.        follows _s_t_r_i_n_g__b in the ASCII collating sequence; otherwise, the
  52.        result is false.  Note that the result is true if both _s_t_r_i_n_g__a and
  53.        _s_t_r_i_n_g__b are of equal length; this includes zero-length strings.
  54.  
  55.      * LLGGTT.  The result is true if _s_t_r_i_n_g__a follows _s_t_r_i_n_g__b in the ASCII
  56.        collating sequence; otherwise, it is false.  The result is false if
  57.        both _s_t_r_i_n_g__a and _s_t_r_i_n_g__b are of zero length.
  58.  
  59.      * LLLLEE.  The result is true if the strings are equal or if _s_t_r_i_n_g__a
  60.        precedes _s_t_r_i_n_g__b in the ASCII collating sequence; otherwise, it is
  61.        false.  Note that the result is true if both _s_t_r_i_n_g__a and _s_t_r_i_n_g__b
  62.        are of equal length; this includes zero-length strings.
  63.  
  64.      * LLLLTT.  The result is true if _s_t_r_i_n_g__a precedes _s_t_r_i_n_g__b in the ASCII
  65.        collating sequence; otherwise, it is false.  The result is false if
  66.        both _s_t_r_i_n_g__a and _s_t_r_i_n_g__b are of zero length.
  67.  
  68. NNOOTTEESS
  69.      When using the MIPSpro Fortran 77 compiler, the --ii22 command line
  70.      option can affect the size of the value returned.
  71.  
  72.      When using the CF90 or MIPSpro 7 Fortran 90 compilers, the return
  73.      value is of type default logical.
  74.  
  75. SSEEEE AALLSSOO
  76.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  77.      man page.
  78.